home *** CD-ROM | disk | FTP | other *** search
/ Aminet 39 / Aminet 39 (2000)(Schatztruhe)[!][Oct 2000].iso / Aminet / gfx / show / gsaview.readme < prev    next >
Encoding:
Text File  |  2000-09-02  |  5.2 KB  |  172 lines
  1. Short:    GsAView - View ghostscript output with anti-aliasing
  2. Author:   olethros@geocities.com (Christos Dimitrakakis)
  3. Uploader: olethros@geocities.com (Christos Dimitrakakis)
  4. Version:  0.11 - Very early version
  5. Type:     gfx/show
  6. Requires: 1MB Chip, 4.5MB Fast
  7.  
  8.  
  9. Latest Changes
  10. --------------
  11.  
  12. Bugfix - It was crashing when FBlit was running
  13.  
  14.  
  15. Overview
  16. ========
  17. This program was put together rather quickly :)
  18. It converts a monochrome 1700x2200 (200dpi) page output from ghostscript into a
  19. 850x1100 anti-aliased 8-color grayscale page, which is then displayed onto a
  20. screen.
  21. Useful for those of us who do not have 1700 pixel wide displays :)
  22.  
  23.  
  24. Usage
  25. =====
  26.  
  27. Syntax: GsAView [-m] [filename]
  28.  
  29. View a single file
  30. ------------------
  31. GsAView filename
  32.    (Exit by holding down the RMB)
  33.  
  34. View a list of files
  35. --------------------
  36. GsAView -m filename
  37.    This tries to read a list of files named
  38.    filename_xxxx.ilbm
  39.    Where xxxx is a list of numbers {0001,0002,....}
  40.    This is the default output of the amiga_ilbm device in gs5.1.0
  41.    Look below for more details
  42.  
  43.  
  44. Using with gs5.1.0
  45. ==================
  46.  
  47. (gs5.1.0 is available from aminet:text/dtp/)
  48.  
  49.  
  50. /- Viewing a single page -/
  51. --------------------------
  52.  
  53. gs -r200 -g1700x2200 -sDEVICE=amiga_ilbm -sOutputFile=path/filename document
  54. (The -g1700x2200 argument is not strictly necessary, but it is safer.. )
  55.  
  56. ..then, when the page is rendered just start GsAView,or otherwise run it like
  57. this:
  58.  
  59. GsAView path/filename_XXXX.ilbm
  60.  
  61. Use L-Amiga and the mouse button to drag the screen.
  62. Click the right mouse button to exit.
  63.  
  64.  
  65. /- Viewing a complete document -/
  66. ---------------------------------
  67.  
  68. Because amiga_ilbm device appends _XXXX.ilbm to the filename it is possible to
  69. shift through pages using GsAView:
  70.  
  71. First, prepare the output files:
  72.  
  73. gs -dNOPAUSE -r200 -g1700x2200 -sDEVICE=amiga_ilbm -sOutputFile=path/filename document
  74.  
  75. Then,
  76.  
  77. GsAView -m path/filename
  78.  
  79. (Note:  You do not have to wait for all files to be created before you start
  80. viewing them.)
  81.  
  82. Press -,+ on the main keyboard to change pages, or use the GUI on the workbench
  83. screen. Close the GUI to exit.
  84.  
  85.  
  86. Problems (aka BUGS)
  87. -------------------
  88. No error checking is done when loading the bitmap!
  89. It must be a single bitplane 1700x2200 bitmap!
  90. If any other file or a directory, is supplied, GsAView will crash horribly!!
  91.  
  92.  
  93.  
  94. Technical details
  95. -----------------
  96. The program was quickly put together using blitz, which has a fast operation for
  97. loading an image into a bitmap (faster than datatypes, I guess)
  98.  
  99. A custom screen is then opened with this bitmap as a custom bitmap.
  100. A 3.7MB buffer is initialized and ReadPixelArray8 is used to get the data from
  101. the screen to the buffer. The bitmap data is then freed.
  102. A 0.8Mb buffer is initialized for the scaled image.
  103. The scaling operation is a 5-point filter with a highly optimized assembly
  104. innerloop (it uses reduces mem-reads from 5 to 3). The scaling takes 1s on my
  105. 68030@50Mhz.
  106. A new screen, with depth 3, and using the SA_LikeWorkbench attribute, is created
  107. and WritePixelArray8 is used to display the data.
  108.  
  109. I decided not to support other BitMap sizes because 2->1 scaling is much faster
  110. than arbitrary scaling, which would need a real filter matrix, which in turn
  111. necessitates the use of multiplication operations and more memory accesses.
  112.  
  113. The Future
  114. ----------
  115.  
  116. I might, just might, extend this program to work with arbitrary image sizes,
  117. (but still 2->1 scaling), and use datatypes!. Ooh!
  118. I guess it could be done using the datatype.library render methods onto a
  119. window and then get it using ReadPixelArray8. Might be an easier way?
  120.  
  121. If you have any ideas, suggestions, comments, or bug reports (apart from the
  122. known ones), please send me an email.
  123.  
  124. PS.
  125. It is possible that I might have no access to email starting from March. In case
  126. you want to communicate something important to me (dunno what, how about sending
  127. some money? :)
  128. send snail-mail to:
  129.  
  130. Christos Dimitrakakis
  131. Agias Sofias 4
  132. Drama 66100
  133. Greece
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140. Look at other weird stuff from me:
  141.  
  142. /demo/aga/nebula.lha          -  Cool Spacey demo
  143. /dev/basic/bgp.lha            -  Blitz Genetic-Programming Environment
  144. /dev/basic/gasp.lha           -  Genetic Algorithm Sample Packer in Blitz
  145. /dev/misc/SimpTrans.lha       -  Simple Automatic Translation of .ct files!
  146. /dev/misc/ST_uk2gr.lha        -  Uk2Gr phrasebook for SimpTrans
  147. /dev/misc/YAAV.lha            -  YAAV V0.99 - Yet Another Autodoc Viewer
  148. /game/shoot/allrox.lha        -  HardCore FRENETIC shootem'up - HARD! FAST! OUCH!
  149. /game/actio/wreckage.lha      -  Experimental Driving Sim
  150. /game/actio/wreckage_src.lha  -  Source for driving sim (older version)
  151. /gfx/show/gsaview.lha         -  View ghostscript output with anti-aliasing
  152. /mus/misc/filtersound.lha     -  Cli-Based FIR/IIR sample filter
  153. /util/pack/agf.lha            -  AGF V0.9 n*8-bit Sample Pre-Packing Processor
  154.  
  155.  
  156.  
  157. Olethros
  158. --------
  159.  
  160. http://members.xoom.com/cdimita
  161. http://www.mp3.com/olethros
  162.  
  163.  
  164. ============================= Archive contents =============================
  165.  
  166. Original  Packed Ratio    Date     Time    Name
  167. -------- ------- ----- --------- --------  -------------
  168.    42392   22503 46.9% 22-Jul-00 00:12:22  gsaview
  169.     4922    2371 51.8% 22-Jul-00 00:20:02  gsaview.readme
  170. -------- ------- ----- --------- --------
  171.    47314   24874 47.4% 22-Jul-100 20:36:24   2 files
  172.